home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / gemv.z / gemv
Encoding:
Text File  |  2002-10-03  |  5.8 KB  |  141 lines
  1. GEMV(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSGGEEMMVV, DDGGEEMMVV, CCGGEEMMVV, ZZGGEEMMVV - Multiplies a real or complex vector by a
  6.      real or complex general matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSGGEEMMVV ((_t_r_a_n_s,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDGGEEMMVV ((_t_r_a_n_s,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  16.  
  17.      Complex
  18.  
  19.         CCAALLLL CCGGEEMMVV ((_t_r_a_n_s,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  20.  
  21.      Double complex
  22.  
  23.         CCAALLLL ZZGGEEMMVV ((_t_r_a_n_s,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      SSGGEEMMVV and DDGGEEMMVV multiply a real vector by a real general matrix.
  30.  
  31.      CCGGEEMMVV and ZZGGEEMMVV multiply a complex vector by a complex general matrix.
  32.  
  33.      These routines perform one of the following matrix-vector operations:
  34.  
  35.           _y <-  _a_l_p_h_a _A_x + _b_e_t_a _y
  36.                        _T
  37.           _y <-  _a_l_p_h_a _A _x + _b_e_t_a _y
  38.                        _H
  39.           _y <-  _a_l_p_h_a _A _x + _b_e_t_a _y
  40.  
  41.      where
  42.  
  43.      * where _a_l_p_h_a and _b_e_t_a are scalars,
  44.  
  45.      * _x and _y are vectors
  46.  
  47.      * _A is an _m-by-_n general matrix
  48.         _T
  49.      * _A  is the transpose of _A
  50.         _H
  51.      * _A  is the conjugate transpose of _A
  52.  
  53.      These routines have the following arguments:
  54.  
  55.      _t_r_a_n_s     Character*1.  (input)
  56.                Specifies the operation to be performed:
  57.  
  58.                _t_r_a_n_s = 'N' or 'n':  _y <- _a_l_p_h_a _A_x + _b_e_t_a _y
  59.  
  60.                                                   _T
  61.                _t_r_a_n_s = 'T' or 't':  _y  <-  _a_l_p_h_a _A _x + _b_e_t_a _y
  62.  
  63.                                                 _T
  64.                _t_r_a_n_s = 'C' or 'c':  _y <- _a_l_p_h_a _A _x + _b_e_t_a _y (SSGGEEMMVV, DDGGEEMMVV),
  65.                or
  66.                              _H
  67.                _y  <-  _a_l_p_h_a _A _x + _b_e_t_a _y (CCGGEEMMVV, ZZGGEEMMVV)
  68.  
  69.      _m         Integer.  (input)
  70.                Specifies the number of rows in matrix _A.  _m >= 0.
  71.  
  72.      _n         Integer.  (input)
  73.                Specifies the number of columns in matrix _A.  _n >= 0.
  74.  
  75.      _a_l_p_h_a     Scalar alpha.  (input)
  76.                SSGGEEMMVV: Real.
  77.                DDGGEEMMVV: Double precision.
  78.                CCGGEEMMVV: Complex.
  79.                ZZGGEEMMVV: Double complex.
  80.  
  81.      _a         array of dimension (_l_d_a,_n).  (input)
  82.                SSGGEEMMVV: Real array.
  83.                DDGGEEMMVV: Double precision array.
  84.                CCGGEEMMVV: Complex array.
  85.                ZZGGEEMMVV: Double complex array.
  86.                Before entry, the leading _m-by-_n part of array _a must
  87.                contain the matrix of coefficients.
  88.  
  89.      _l_d_a       Integer.  (input)
  90.                Specifies the first dimension of _a as declared in the
  91.                calling program.  _l_d_a >= MMAAXX(1,_m).
  92.  
  93.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x| when _t_r_a_n_s = 'N' or 'n',
  94.                and at least 1+(_m-1) * |_i_n_c_x| otherwise.  (input)
  95.                SSGGEEMMVV: Real array.
  96.                DDGGEEMMVV: Double precision array.
  97.                CCGGEEMMVV: Complex array.
  98.                ZZGGEEMMVV: Double complex array.
  99.                Contains the vector _x.  Before entry, the incremented array
  100.                _x must contain the vector _x.
  101.  
  102.      _i_n_c_x      Integer.  (input)
  103.                Specifies the increment for the elements of _x.  _i_n_c_x must
  104.                not be 0.
  105.  
  106.      _b_e_t_a      Scalar beta.  (input)
  107.                SSGGEEMMVV: Real.
  108.                DDGGEEMMVV: Double precision.
  109.                CCGGEEMMVV: Complex.
  110.                ZZGGEEMMVV: Double complex.
  111.                When _b_e_t_a is supplied as 0, _y need not be set on input.
  112.  
  113.      _y         Array of dimension 1+(_m-1) * |_i_n_c_y| when _t_r_a_n_s = 'N' or 'n',
  114.                and at least 1+(_n-1) * |_i_n_c_y| otherwise.  (input) (input and
  115.                output)
  116.                SSGGEEMMVV: Real array.
  117.                DDGGEEMMVV: Double precision array.
  118.                CCGGEEMMVV: Complex array.
  119.                ZZGGEEMMVV: Double complex array.
  120.                Contains the vector _y.  Before entry with _b_e_t_a as non-zero,
  121.                the incremented array _y must contain the vector _y.  On exit,
  122.                _y is overwritten by the updated vector _y.
  123.  
  124.      _i_n_c_y      Integer.  (input)
  125.                Specifies the increment for the elements of _y.  _i_n_c_y must
  126.                not be 0.
  127.  
  128. NNOOTTEESS
  129.      SSGGEEMMVV, DDGGEEMMVV and CCGGEEMMVV, ZZGGEEMMVV are Level 2 Basic Linear Algebra
  130.      Subprograms (Level 2 BLAS).
  131.  
  132.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), each routine starts at
  133.      the end of the vector and moves backward, as follows:
  134.  
  135.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)) , ..., _x(1)
  136.  
  137.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)) , ..., _y(1)
  138.  
  139. SSEEEE AALLSSOO
  140.      This man page is available only online.
  141.